Technical specifications
.dmg/Shareware World/Comms & Internet/AutoShare3.0.4/Documentation/images/autoshare.GIF)
AutoShare, a freeware EIMS companion application.
A list server and auto-responder for the Macintosh.
This document is copyright © 1998 Mikael Hansen.
Table of Contents
While technical specifications are, well, technical, they may lead to insight not offered elsewhere in the documentation and so serve as a useful source of information.
AutoShare Preferences and list-specific configuration
You may skip the section on
The AutoShare Preferences file and its list-specific configuration,
if you prefer to do so. All preferences, only in part supported by the user interface of AutoShare, are fully scriptable as described in the notes on the
AutoShare scriptability. You may also wish to go straight to the
AutoShare Admin application, whose user interface benefits from the full scriptability of AutoShare and so has access to all preferences.
The terms default and override are used often in this section. The generic meaning of these two words is applied to the list-specific configuration of AutoShare to indicate, that if you don't go out of your way to configure a given setting for a list, the respective general setting will be used instead. Many lists frequently share the same settings, which conveniently may be configured on the general level (a list-specific setting defaults to a general setting), whereas truly list-specific settings may be configured on a list level (a list-specific setting overrides a general setting). As a rule, strings being blank and numeric values of -1 are most often the override values indicating default.
The AutoShare Preferences file resides in the AutoShare folder within the System 7 Preferences folder and is created automatically by AutoShare, when starting up.
List-specific settings
AutoShare also initializes the list-specific settings in this file by creating standard default values, when starting up. The list-specific configuration is stored in STR# 1001 and upwards, one STR# per list. Index numbers for fields and description of values within these are:
- 1: list name (AutoShare creates this key)
- 2: listmaster's e-mail address (defaults to blank, general configuration)
- 3: listmaster's name (defaults to blank, general configuration)
- 4: list type
- '0' = based on general configuration (default)
- '1' = subscription
- '2' = open (has turned list-specific)
- '3' = moderated
- '4' = announcement
- '5' = private
- 5: reply-to
- '0' = based on general configuration (default)
- '1' = list
- '2' = sender
- '3' = the address you place in the next field (6)
- '4' = adds no Reply-To field
- 6: address string (defaults to blank, general configuration)
- 7: subscribers in review
- '0' = based on general configuration (default)
- '1' = show names
- '2' = suppress names
- 8: conceal
- '0' = based on general configuration (default)
- '1' = visible
- '2' = concealed
- 9: digest
- '0' = based on general configuration (default)
- '1' = messages
- '2' = digest
- 10: mail
- '0' = based on general configuration (default)
- '1' = mail
- '2' = no mail
- 11: ack
- '0' = based on general configuration (default)
- '1' = no acknowledgement
- '2' = acknowledgement
- 12: maximum archive messages (e.g. '200') for rollover feature (defaults to '-1', general configuration; '0' ignores the feature)
- 13: maximum lines (e.g. '150') in contribution response (defaults to '-1', general configuration; '0' ignores the feature)
- 14: minimum percentage of unquoted lines (e.g. '50') in contribution response (defaults to '-1', general configuration; '0' ignores the feature)
- 15: X-See-Also RFC field body (defaults to blank, general configuration), e.g. web URL
- 16: GetList returns the number of subscribers, if property is greater than zero on entry
- 17: alternate names for the user names of the EIMS .m and .d mailing list accounts
- 18: hide list
- '0' = based on general configuration (default)
- '1' = the List command displays the list
- '2' = the List command hides the list
- 19: the entry point path for the web archives (defaults to blank, general configuration)
- 20: mail-back confirmation for list server commands (defaults to blank, general configuration);
adding a capitalized letter to the string enables mail-back for the command in question
- 'S' = sub
- 'U' = unsub
- 'E' = set
- 'Q' = query
- 'R' = review
- 'I' = index
- 'G' = get
- 'H' = search
- 'W' = which
- 'L' = list
- 'C' = release
- 'N' = none
- 'A' = all
- 21: subject prefix of list contributions (defaults to blank, general configuration)
- 22: password for remote e-mail (defaults to blank, general configuration)
- 23: post
- '0' = based on general configuration (default)
- '1' = post
- '2' = no post
- 24: suppressing various RFC headers
- '1' = List-Subscribe
- '2' = List-Unsubscribe
- '3' = X-List-Digest
- '4' = List-Archive
- '5' = List-Post
- '6' = X-List-Host
- '7' = List-Admin
- '8' = List-Help
- '9' = X-To-Unsubscribe
- 25: a string holding various list settings, normally not used (defaults to blank, general configuration)
- 26: address protection
- '0' = based on general configuration (default)
- '1' = disabled
- '2' = enabled
- 27: tip of the day list
- '0' = based on general configuration (default)
- '1' = disabled
- '2' = enabled
- 28: announcement or moderated list contributions may be approved by either the envelope sender or the RFC From
- '0' = based on general configuration (default)
- '1' = disabled
- '2' = enabled
- 29: hard bounces causes subscribers to be unsubscribed
- '0' = based on general configuration (default)
- '1' = enabled
- '2' = disabled
- 30: a string indicating the user language
- 31: database format for subscribers
- '0' = based on general configuration (default)
- '1' = standard
- '2' = script
- '3' = built-in
General list settings
STR# 1000 holds the general configuration for lists and uses the layout of fields and values for the list-specific settings. You probably have to update the configuration for only some of the fields for a given list: if the fields marked in the general configuration contain the same data as you would like to apply to the list, they are considered default values for the list if you leave the respective list-specific fields alone.
- 1: not used
- 2: address of the administrator (defaults to blank)
- 3: name of the administrator (defaults to blank)
- 4: list type (defaults to '1' = subscription)
- 5: reply-to (defaults to '1' = list)
- 6: address string (defaults to blank)
- 7: subscribers in review (defaults to '1' = show names)
- 8: conceal (defaults to '1' = visible)
- 9: digest (defaults to '1' = messages)
- 10: mail (defaults to '1' = mail)
- 11: ack (defaults to '1' = no acknowledgement)
- 12: maximum archive messages for rollover feature (defaults to '0')
- 13: maximum lines in contribution response (defaults to '0')
- 14: minimum percentage of unquoted lines in contribution response (defaults to '0')
- 15: X-See-Also RFC field body (defaults to blank)
- 16: not used, as GetList applies to actual lists only
- 17: not used, as the .m and .d accounts apply to actual lists only
- 18: hide list (defaults to '1' = display)
- 19: the entry point path for the web archives (defaults to blank)
- 20: mail-back confirmation for list server commands (defaults to blank)
- 21: subject prefix of list contributions (defaults to blank)
- 22: password for remote e-mail (defaults to blank)
- 23: post (defaults to '1' = post)
- 24: suppressing various RFC headers (defaults to blank)
- 25: various list settings (defaults to blank)
- 26: address protection (defaults to '1' = disabled)
- 27: tip of the day list (defaults to '1' = disabled)
- 28: approved by either (defaults to '1' = disabled)
- 29: hard bounces unsubscribes (defaults to '1' = enabled)
- 30: the user language (defaults to blank)
- 31: database format for subscribers (defaults to '1' = standard)
Miscellaneous settings
Some server configuration not relating to lists is kept in STR# 201 (string values default to blank):
- 1: name of the list server address (e.g. 'AutoShare List Server', defaults to blank)
- 2: status window when in background
- '0' = hide window (default)
- '1' = show window
- 3: the bounce account address (defaults to blank
- 4: name of the bounce account address (e.g. 'AutoShare Bounce Account', defaults to blank)
- 5: purging of non-existing lists for list-specific resources
- '0' = no purging when starting up (default)
- '1' = purging when starting up
- 6: processing delay in seconds (defaults to '0')
- 7: relinguished foreground processing time in ticks (defaults to '5')
- 8: default creator for processed files (defaults to 'ttxt')
- 9: default file type (defaults to 'TEXT')
- 10: Preferences creator for processed files (defaults to 'RSED')
- 11: Preferences file type (defaults to 'rsrc')
- 12: in minutes, how often AutoShare checks for expired message files in the Hold Mail folder (defaults to '10')
- 13: the number of minutes from when the unconfirmed message file was created until it expires and is deleted (defaults to '600')
- 14: list sort
- '1' = Unsorted
- '2' = Domain (default)
- '3' = User
- 15: process time
- '1' = None
- '2' = All
- '3' = Message
- '4' = Log (default)
- 16: MIME string
- '1' = Text Plain (default)
- '2' = MIME QP
- 17: in minutes, how often AutoShare sends test bounce messages to bounce entry addresses (defaults to '1440')
- 18: the value of the received bounce counter, at which subscriber addresses of soft bounce entries are unsubscribed (defaults to '5')
- 19: the difference between the sent bounce counter and the received bounce counter, at which subscriber addresses of soft bounce entries are considered stable (defaults to '3')
- 20: the number of minutes from when the bounce entry was created until it is deleted, if not already otherwise removed (defaults to '10080')
- 21: list-specific web archives
- '1' = Complete (default)
- '2' = Minimal
- 22: the contents of the X-List-Host RFC field (defaults to blank)
- 23: subscriber addresses
- '0' = envelope sender (default)
- '1' = RFC From
- 24: subscriber alias files
- '0' = not used (default)
- '1' = used
- 25: number of characters per formatted line in documents (defaults to '80')
- 26: applications are kept up every these many minutes (defaults to '10')
- 27: adjusting the processing mode every these many minutes (defaults to '60')
- 28: the position of the status window's upper left corner (vertical pixels, space, horizontal pixels; defaults to blank)
- 29: a string holding various Misc settings, normally not used (defaults to blank)
- 30: front-to-back order of status windows when shutting down and starting AutoShare (not configurable)
- 31: level of suppression for list server commands on lists
- 32: appended label for user part of list server address when using multiple preference sets in a single-domain environment
- 33: adjusting the locked mode every these many minutes (defaults to '60')
- 34: unknown addresses
- a blank string bounces the message
- an e-mail address sends the message to the address
- @<domain> sends the message to the same user of the specified domain
- <user> or <user>@ sends the message to the specified user of the current domain
- 35: the number of minutes from when the subscriber is softly removed until the bounce entry is removed (defaults to 7200)
The user interface of AutoShare takes care of STR# 1000,2, STR# 201,3 plus all configuration in STR# 202,
203,1-6 and 204. The rest cannot be configured within the AutoShare interface. You may use a resource editor (such as ResEdit), or much better, an OSA-compliant scripting language such as AppleScript (specific commands are supported in most cases, the SetRes command is needed in a few instances only) to update your configuration for the above.
All of the configuration data may be viewed in the AutoShare Analysis file. Or perhaps best is the user interface of the AutoShare Admin, which communicates with AutoShare via scripting.
PowerPC native AutoShare
AutoShare, written using
Metrowerks CodeWarrior Pro 4,
is both 68K (in the 68K folder) and PowerPC (in the PPC folder) native. AutoShare is written in the Pascal and C languages.
The 68K native server application requires 832K of memory.
The development environment of AutoShare does not rely on a framework such as
PowerPlant or
MacApp.
The PowerPC native version is compiled and linked directly from sources to application
and does not use a PowerPC conversion tool such as
MacApp2PPC.
When AutoShare 1.0 was released, it was the first 68K list server for the Mac,
and with the release of version 1.1, AutoShare was also the first true PPC native list server for the Mac.
Last updated on December 30 1998 by Mikael Hansen